/**
* Copyright (C) 2013-2024 Nanjing Pengyun Network Technology Co., Ltd.
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
*     http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/ 

package py.datanode.page;

import py.archive.page.PageAddress;
import py.datanode.configuration.DataNodeConfiguration;
import py.datanode.page.impl.StorageIoDispatcher;
import py.exception.StorageException;

public interface PageManager<P extends Page> {
  public void checkout(PageContext<P> pageContext);

  public PageContext<P> checkoutForRead(PageAddress address);

  public PageContext<P> checkoutForExternalRead(PageAddress address);

  public PageContext<P> checkoutForInternalWrite(PageAddress address);

  public PageContext<P> checkoutForExternalWrite(PageAddress address);

  public PageContext<P> checkoutForInternalCorrection(PageAddress address);

  public PageContext<P> checkoutForExternalCorrection(PageAddress address);

  public void checkin(PageContext<P> pageContext);

  public void flushPage(PageContext<P> pageContext);

  public int recordFlushError(PageAddress pageAddress);

  public long getTotalPageCount();

  public long getFreePageCount();

  public long getDirtyPageCount();

  void start();

  public void close() throws InterruptedException;

  public boolean isClosed();

  public DataNodeConfiguration getCfg();

  public boolean cleanCache();

  StorageIoDispatcher getStorageIoDispatcher();
}
